Explicitely mention -1 in the insert_with_values docs
authorPaolo Borelli <pborelli@gnome.org>
Sat, 10 Mar 2012 18:32:56 +0000 (19:32 +0100)
committerPaolo Borelli <pborelli@gnome.org>
Sat, 10 Mar 2012 18:37:07 +0000 (19:37 +0100)
-1 means "append". Spell it out like we do for ListStore docs.

gtk/gtktreestore.c

index 1c6d63638b3deee56076a81e2d238a191933b9b2..773a2562d82d95f64dc86eaccf734017df5fd674 100644 (file)
@@ -1490,11 +1490,11 @@ gtk_tree_store_insert_after (GtkTreeStore *tree_store,
  * @tree_store: A #GtkTreeStore
  * @iter: (out) (allow-none): An unset #GtkTreeIter to set the new row, or %NULL.
  * @parent: (allow-none): A valid #GtkTreeIter, or %NULL
- * @position: position to insert the new row
+ * @position: position to insert the new row, or -1 to append after existing rows
  * @...: pairs of column number and value, terminated with -1
  *
  * Creates a new row at @position. @iter will be changed to point to this
- * new row. If @position is larger than the number of rows on the list, then
+ * new row. If @position is -1, or larger than the number of rows on the list, then
  * the new row will be appended to the list. The row will be filled with
  * the values given to this function.
  *